home *** CD-ROM | disk | FTP | other *** search
/ Go64! / Go64_1999-03_1999_CSW_Side_B.d64 / jammon2 docs < prev    next >
Text File  |  2023-02-26  |  3KB  |  120 lines
  1. qUICK DOCS FOR jAMAICAmon slj 1/31/97 SJUDD@NWU.EDU
  2. -------------------------
  3.  
  4. VERSION 2.0:
  5.  
  6. - nOTE THAT V2 IS LARGER THAN 4K; DON'T RELOCATE TO $c000!
  7.  
  8. fORMAT:
  9.  BYTE  TWO CHARACTERS -- USE 09 INSTEAD OF 9.  eXCEPTION IS
  10. LOAD AND SAVE, WHERE THE DEVICE NUMBER MAY BE 1 OR 2 CHARS
  11. (BUT IS STILL IN HEX).
  12.  
  13.  ADDR16 OR 24 BITS -- TWO OR THREE BYTES.
  14.  
  15. iF A 16-BIT ADDRESS IS USED, THE CURRENT VALUE OF pbr IS 
  16. PREPENDED TO FORM A 24-BIT ADDRESS (E.G. D C000 WILL DISASSEMBLE 
  17. AT $01c000 IF pbr=01).
  18.  
  19. nOTES:
  20. iF e=1 THEN x=m=1
  21.  
  22. 24-BIT LOAD/SAVE IS SUPPORTED VIA cmd LOAD/SAVE PATCH.
  23.  
  24. rEQUIRES A sUPERcpu!
  25.  
  26. cOMMANDS
  27. --------
  28.  
  29. AA ADDR COMMAND
  30. aSSEMBLE.  nUMBERS/ADDRESSES ARE IN HEX AND PREFIXED BY A $.
  31. <!> ARE VALID IN ABSOLUTE ADDRESSING TO FORCE 8/16/24 BIT ADDRESSES.
  32. tHE FLAGS (SEE R) DETERMINE WHETHER IMMEDIATE MODE IS BE ASSEMBLED
  33. AS 8 OR 16 BITS.  !X AND !M MAY BE USED TO FLIP THE x AND m BITS
  34. DURING ASSEMBLY (!! WILL FLIP BOTH; NOTE THAT x=m=1 WHEN E=1).
  35.  
  36. DD ADDR
  37. dISASSEMBLE ONE SCREEN.
  38.  
  39. <-<-
  40. dISASSEMBLE ONE SCREEN BACKWARDS FROM CURRENT ADDRESS.
  41.  
  42. {$7b}LIRA{$7d}{$7b}LIRA{$7d}
  43. tOGGLE WHETHER DISASSEMBLER FOLLOWS rep AND sep.  nOTE THAT IF e=1
  44. THEN x=m=1 ALWAYS.  (i FELT THE LIRA KEY WAS GROWING LONELY FROM
  45. NEGLECT, SO HE GETS THE TOGGLE HONOR).
  46.  
  47. ,, ADDR BYTE1 [BYTE2 ...]
  48.  rE-DISASSEMBLE.  tHE BYTES FOLLOWING THE ADDRESS ARE READ IN AND 
  49. STORED, AND THE SCREEN IS RE-DISASSEMBLED.
  50.  
  51. PP ADDR1 ADDR2
  52. dISASSEMBLE RANGE.
  53.  
  54. R/ENO ARGS
  55. dISPLAY REGS/ALTERNATE REGS.  nOTE THAT VALUE OF FLAGS, pbr,
  56. AND $01 CAN ALTER CERTAIN COMMANDS: FLAGS DETERMINE 8/16 BIT
  57. #IMMEDIATE MODE ASSEMBLY AND DISASSEMBLY, pbr CHANGES DEFAULT
  58. ADDRESS LOCATIONS, AND $01 AFFECTS ANY MEMORY READ (DISASSEMBLY,
  59. MEMORY DISPLAY, ETC.)
  60.  
  61. MM ADDR1 [ADDR2]
  62. dISPLAY MEMORY.  iF A SECOND ADDRESS IS SPECIFIED, DISPLAY MEMORY
  63. RANGE.
  64.  
  65. II ADDR1 [ADDR2]
  66.  dISPLAY MEMORY+TEXT.  mEMORY CAN'T BE MODIFIED LIKE M COMMAND
  67. (NOT ENOUGH ROOM ON THE SCREEN LINE!).
  68.  
  69. HH ADDR1 ADDR2 BYTE1 [BYTE2 ...] OR H ADDR1 ADDR2 "STRING"
  70.  hUNT.
  71.  
  72. FF ADDR1 ADDR2 BYTE
  73.   fILL RANGE OF MEMORY WITH SPECIFIED BYTE.
  74.  
  75. TT ADDR1 ADDR2 DEST
  76. tRANSFER MEMORY.
  77.  
  78. NN ADDR1 ADDR2 ADDR3 DEST
  79. rELOCATE CODE.  ADDR1=START OF CODE, ADDR2=START OF VARIABLES,
  80. AND ADDR3=END OF VARIABLES.  tRANSFERS MEMORY AND UPDATES ADDRESSES
  81. BETWEEN ADDR1 AND ADDR2.  tHIS WAY, PROGRAMS (LIKE jAMAICAmon!) THAT 
  82. HAVE CODE FOLLOWED BY VARIABLES AND TABLES CAN BE RELOCATED IN ONE 
  83. SWELL FOOP (USE W TO GET JAMAICAMON ADDRESSES).  yEP, YOU'RE sol
  84. IF YOU JUST WANT TO RELOCATE A TABLE -- MAYBE A FUTURE UPDATE?
  85.  
  86. tO RELOCATE JAMMON, USE W, SET THE DEST ADDRESS, RELOCATE THE
  87. CODE, AND G DEST.
  88.  
  89. WNO ARGS
  90.  wHERE AM i?  pRINTS ADDRESSES OF JAMMON CODE, VARS, AND END.
  91.  
  92. ;^:VARIOUS
  93. aLTER REGS/ALTERNATE REGS/MEMORY (PRINTED BY R AND E)
  94.  
  95. LL "FILENAME",DEV[,ADDR]
  96. lOAD  FILE (TO ADDR IF SPECIFIED).
  97.  
  98. SS "FILENAME",DEV,ADDR1,ADDR2
  99. sAVE FILE
  100.  
  101. BB ADDR
  102. sET BREAKPOINT.  tHE ADDRESS AND PREVIOUS CONTENTS ARE REMEMBERED;
  103. IF THE MONITOR IS THEN RE-ENTERED FROM THIS POINT, THE PREVIOUS
  104. CONTENTS ARE RESTORED.  oNLY ONE BREAKPOINT MAY BE SET AT A TIME.
  105.  
  106. GG [ADDR]
  107. rESTORE REGISTERS AND GO.  iF NO ADDRESS IS SPECIFIED, IT WILL GO TO pc.
  108.  
  109. ZZ [ADDR]
  110. zINGLE ZTEP.  zAME AZ GO, BUT ZETS A BREAKPOINT AT ZE NEXT INZTRUCTION.
  111. (nOTE THAT BRANCHES, jsrS, ETC. WILL NOT BE FOLLOWED).
  112.  
  113. XNO ARGS
  114. eXIT TO BASIC.
  115.  
  116. ?NO ARGS
  117. lIST AVAILABLE COMMAND KEYS
  118.  
  119. tHIS PROGRAM IS IN THE PUBLIC DOMAIN.
  120.